发起一次赠送请求时需要创建一个新的 balance_bonus 对象。
| 请求参数 | 描述 |
|---|---|
| APP_ID required string | 对应 app 对象的 id,该参数仅需要填写在请求地址内,查看 如何获取App ID。 |
| amount required int | 受赠金额,单位为分。 |
| user required string | 受赠的 user 对象的 id。 |
| order_no required string | 商户订单号,必须在商户的系统内唯一,64 位以内。 |
| description optional string | 附加说明,最多 60 个 Unicode 字符。 |
| metadata optional hash | 详见 元数据。 |
返回
返回一个 balance_bonus 对象,或者一个错误,详见 错误。
POST https://api.pingxx.com/v1/apps/{APP_ID}/balance_bonuses待补充
待补充
待补充
待补充
待补充
待补充
待补充
curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/balance_bonuses \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1496728534" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d {
"amount": 1000,
"user": "test_user_001",
"order_no": "2017071110258972"
"description": "余额赠送描述"
}待补充
待补充
待补充
待补充
待补充
待补充
待补充
{
"id": "311317071315160600000100",
"object": "balance_bonus",
"app": "app_1Gqj58ynP0mHeX1q",
"created": 1496728534,
"livemode": false,
"paid": true,
"refunded": false,
"amount": 100,
"amount_refunded": 0,
"time_paid": 1496728594,
"user": "user_007",
"order_no": "2017071110258972",
"balance_transaction": "310317060612081500000501",
"description": "余额赠送",
"metadata": {}
}